IviFgen Create Channel Arbitrary Waveform [ACH] VI

IviFgenArbChannelWfm [ACH] Capability Group

This VI creates a channel-specific arbitrary waveform and returns a handle that identifies that waveform. You pass this handle to the IviFgen Configure Arbitrary Waveform [ARB] VI to produce that waveform. You also use the handles this VI returns to specify a sequence of arbitrary waveforms with the IviFgen Create Arbitrary Sequence [SEQ] VI.

If the instrument does not support channel-based arbitrary waveform creation, use the IviFgen Create Arbitrary Waveform VI.

Use the following VIs to create a channel-specific arbitrary waveform if you want to pass data in 16-bit or 32-bit binary:

IviFgen Create Channel Arbitrary Waveform [ACH].vi

instrument handle The instrument handle that you obtain from the IviFgen Initialize or IviFgen Initialize With Options VI.
iivrn instrument handle out The instrument handle that you obtain from the IviFgen Initialize or IviFgen Initialize With Options VI.
channel name ("CHANNEL1") Pass the virtual channel name that you assign to the instrument in the Configuration Utility.

Virtual channel names are aliases for instrument-specific channel strings. The instrument-specific channel strings can differ from one instrument to another. Virtual channel names allow you to use and swap instruments without having to change the channel names in your source code. You assign a virtual channel name to an instrument-specific channel through the Configuration Utility. This control accepts virtual channel names you have assigned to the specific instrument you are using. It also accepts the instrument-specific channel names.

If the instrument has multiple channels, you can pass a comma-separated list of channel names to create multi-channel waveform.

Default Value: "CHANNEL1"

Note Note  You can specify the channel name as a string variable or as a literal enclosed in double quotes.
c1ddbl waveform data array Specify the array of data you want to use for the new arbitrary waveform. The array must have at least as many elements as the value you specify in the waveform size control.

You must normalize the data points in the array to be between -1.00 and +1.00.

When you create a multi-channel waveform, this array is the concatenation of the waveform arrays for each channel. In this case, all waveforms must be of the same length.

Default Value: None
ii32 waveform handle Returns the handle that identifies the new arbitrary waveform. Pass this handle to the IviFgen Configure Arbitrary Waveform [ARB] VI to generate the arbitrary waveform. Pass an array of these handles to the IviFgen Create Arbitrary Sequence [SEQ] VI to create an arbitrary sequence.
ci64 waveform size Pass the size of the arbitrary waveform you want to create.

The size must meet the following restrictions:

  • The size is less than or equal to the maximum waveform size the instrument allows.
  • The size is greater than or equal to the minimum waveform size the instrument allows.
  • The size is an integer multiple of the instrument's waveform quantum.

You can obtain these values from the Maximum Waveform Size, Minimum Waveform Size, and Waveform Quantum controls of the IviFgen Query Arb Wfm Capabilities 64 [ARB64] VI.

Default Value: None
error in (no error) The error in cluster can accept error information wired from VIs previously called. Use this information to decide if any functionality should be bypassed in the event of errors from other VIs.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.
ierrcodeclst error out The error out cluster passes error or warning information out of a VI to be used by other VIs.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.